<html>
  <head>
    <link rel="stylesheet" href="style.css" type="text/css">
    
  </head>
  <body>
    <h1>
      Benutzer-Dienst
    </h1>
    <p>
      Der Benutzer-Dienst ist eine Webapplikation, die standardm&#228;&#223;ig mit dem 
      ServiceHub verteilt wird. Mit ihm k&#246;nnen Webanwendungen ihren Benutzern 
      eine M&#246;glichkeit anbieten, das eigene Kennwort zu &#228;ndern.
    </p>
    <p>
      Webanwendungen, die von ServiceHub aus bereitgestellt werden, verwenden 
      automatisch die Authentifizierung von ServiceHub, wenn sie gem&#228;&#223; der 
      Java EE Spezifikation in ihrem Deployment Descriptor (<font face="Monospace, Monospaced">web.xml</font>) 
      sogenannte Security Constraints enthalten. Die Anlage und Pflege von <a href="kapitel7.htm">Rollen</a>, 
      <a href="kapitel8.htm">Benutzern</a> und Zuordnungen von Rollen zu 
      Benutzern erfolgt dabei durch den Administrator &#252;ber die 
      Bedienoberfl&#228;che des ServiceHub.
    </p>
    <h2>
      Kennwort &#252;ber den Benutzer-Dienst &#228;ndern
    </h2>
    <p>
      Soll eine Webanwendung ihren Benutzern erm&#246;glichen, das vom 
      Administrator in ServiceHub hinterlegte eigene Kennwort zu &#228;ndern, kann 
      sie die Methode <font face="Monospace, Monospaced">changePass</font> des 
      Benutzer-Dienstes verwenden. Die Benutzung funktioniert nur, wenn der 
      Benutzer bereits an ServiceHub authentifiziert ist. Die Methode <font face="Monospace, Monospaced">changePass</font> 
      wird wie folgt aufgerufen
    </p>
    <p style="margin-top: 6; margin-left: 20">
      <font face="Monospace, Monospaced">http://[IP-Adresse von 
      ServiceHub]:[Port von 
      ServiceHub]/UserService/User/changePass?cpw=[current password]&amp;npw=[new 
      password]</font>
    </p>
    <h3>
      Beispiel
    </h3>
    <p style="margin-top: 6; margin-left: 20">
      <font face="Monospace, Monospaced">http://192.168.178.53:8089/UserService/User/changePass?cpw=secret&amp;npw=dont_tell</font>
    </p>
    <p>
      Die Antworten gibt der Benutzer-Dienst per HTTP in XML, sie lauten wie 
      folgt.
    </p>
    <h3>
      Antwort f&#252;r erfolgreiche &#196;nderung des Kennworts
    </h3>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 6; margin-left: 10">
      <font face="Monospace, Monospaced">&lt;xml&gt; </font>
    </p>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 0; margin-left: 20">
      <font face="Monospace, Monospaced">&lt;response method=&quot;changePassword&quot; 
      result=&quot;ok&quot;/&gt; </font>
    </p>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 0; margin-left: 10">
      <font face="Monospace, Monospaced">&lt;/xml&gt;</font>
    </p>
    <h3>
      Antwort bei Fehlern
    </h3>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 6; margin-left: 10">
      <font face="Monospace, Monospaced">&lt;xml&gt; </font>
    </p>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 0; margin-left: 20">
      <font face="Monospace, Monospaced">&lt;response method=&quot;changePassword&quot; 
      result=&quot;Password not changed. Error: Current password does not match.&quot;/&gt; </font>
    </p>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 0; margin-left: 10">
      <font face="Monospace, Monospaced">&lt;/xml&gt;</font>
    </p>
    <p>
      Neben den &#252;blichen Fehlern wie z.B. Verbindungsfehler oder 
      Datenabankfehler k&#246;nnen folgende Fehlerf&#228;lle auftreten:
    </p>
    <ul>
      <li>
        <p>
          Aktuelles Kennwort stimmt nicht mit dem eingegebenen Kennwort &#252;berein
        </p>
      </li>
      <li>
        <p>
          Benutzername wurde nicht gefunden
        </p>
      </li>
    </ul>
    <p>
      Diese lassen sich jeweils am Attribut <font face="Monospace, Monospaced">result</font> 
      ablesen.
    </p>
    <h2>
      Benutzer-Dienst abschalten
    </h2>
    <p>
      Zum Abschalten des Benutzer-Diensts gehen man wie folgt vor
    </p>
    <ol>
      <li>
        <p>
          Eine Kopie des Verzeichnisses <font face="Monospace, Monospaced">[ServiceHub-Installationsverezichnis]/webapps/UserService</font> 
          anfertigen und au&#223;erhalb den Basis-Verzeichnisses von ServiceHub 
          ablegen,
        </p>
      </li>
      <li>
        <p>
          <a href="kapitel11.htm">ServiceHub starten</a>,
        </p>
      </li>
      <li>
        <p>
          <a href="kapitel5.htm">Server starten</a>,
        </p>
      </li>
      <li>
        <p>
          Tab &quot;<a href="kapitel24.htm">Programme</a>&quot; aufrufen,
        </p>
      </li>
      <li>
        <p>
          Benutzer-Dienst in der Liste der Webapplikationen ausw&#228;hlen und
        </p>
      </li>
      <li>
        <p>
          die Schaltfl&#228;che &quot;Undeploy&quot; bet&#228;tigen.
        </p>
      </li>
    </ol>
    <p>
      Damit wird die Webawendung des Benutzer-Dienstes vom ServiceHub gel&#246;scht 
      und steht nicht mehr zur Benutzung durch andere Webapplikationen bereit.
    </p>
    <h2>
      Benutzer-Dienst wieder einschalten
    </h2>
    <p>
      Soll der Benutzer-Dienst eingeschaltet werden, nachdem er wie zuvor 
      beschrieben entfernt wurde, kann man die folgenden Schritte ausf&#252;hren
    </p>
    <ol>
      <li>
        <p>
          Den Inhalt der Kopie des Verzeichnisses <font face="Monospace, Monospaced">UserService</font> 
          in ein ZIP-Archiv verpacken. Wohlgemerkt nur den Inhalt des 
          Verzechnisses, nicht das Verzeichnis selbst.
        </p>
      </li>
      <li>
        <p>
          Das ZIP-Archiv umbenennen in <font face="Monospace, Monospaced">UserService.war</font>
        </p>
      </li>
      <li>
        <p>
          Die Datei <font face="Monospace, Monospaced">UserService.war</font> 
          per Deploy auf dem ServiceHub <a href="kapitel6.htm">installieren</a>
        </p>
      </li>
    </ol>
    <p>
      Damit ist der Benutzer-Dienst wieder aktiv.
    </p>
    <p>
      <b>Wichtig</b>: Der Dateiname muss so lauten wie oben angegeben, 
      einschlie&#223;lich der Gro&#223;- und Kleinschreibung. Andernfalls k&#246;nnen 
      Anwendungen, die mit dem Dienst arbeiten, diesen nicht am erwarteten 
      Uniform Resource Locator (URL) <font face="Monospace, Monospaced">UserService</font> 
      erreichen.
    </p>
    <p>
      
    </p>
    <p>
      
    </p>
    <p>
      <b>Siehe auch</b>
    </p>
    <p>
      <a href="kapitel6.htm">Anwendungen installieren und entfernen</a>
    </p>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 0; margin-left: 0">
      <a href="kapitel7.htm">Rollen verwalten</a>
    </p>
    <p style="margin-bottom: 0; margin-right: 0; margin-top: 0; margin-left: 0">
      <a href="kapitel8.htm">Benutzer verwalten</a>
    </p>
  </body>
</html>
